Skip to content

Add with_read_only() convenience method to store #3138

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 13 commits into from
Jun 19, 2025

Conversation

maxrjones
Copy link
Member

This PR adds a Store.with_read_only() convenience method to create a new store with a different read mode. By default, the method raises a NotImplementedError. The motivation is to make it simpler for downstream libraries to adapt to the changes in #3068. For example, this would make it much simpler to address the 269 failures in Xarray's upstream test suite and the failures in VirtualiZarr's upstream test suite.

This is similar to the functionality added in #2249 and removed in #2442. @jhamman would you be able to offer any details on the motivation for previously removing the similar functionality?

TODO:

  • Add unit tests and/or doctests in docstrings
  • Add docstrings and API docs for any new/modified user-facing classes and functions
  • New/modified features documented in docs/user-guide/*.rst
  • Changes documented as a new file in changes/
  • GitHub Actions have all passed
  • Test coverage is 100% (Codecov passes)

@github-actions github-actions bot added the needs release notes Automatically applied to PRs which haven't added release notes label Jun 17, 2025
@github-actions github-actions bot removed the needs release notes Automatically applied to PRs which haven't added release notes label Jun 18, 2025
Copy link
Contributor

@dstansby dstansby left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice - looks great overall, have left some minor suggestions.

@dstansby dstansby added this to the 3.1.0 milestone Jun 19, 2025
@dstansby dstansby merged commit 286bef8 into zarr-developers:main Jun 19, 2025
30 checks passed
@maxrjones maxrjones deleted the with-read-only branch June 19, 2025 16:10
@d-v-b d-v-b modified the milestones: 3.1.0, 3.0.9 Jun 30, 2025
@d-v-b
Copy link
Contributor

d-v-b commented Jun 30, 2025

@meeseeksdev backport to 3.0.9

meeseeksmachine pushed a commit to meeseeksmachine/zarr-python that referenced this pull request Jun 30, 2025
d-v-b pushed a commit that referenced this pull request Jun 30, 2025
…3181)

Co-authored-by: Max Jones <14077947+maxrjones@users.noreply.github.com>
d-v-b added a commit that referenced this pull request Jul 9, 2025
* Enable tests on 3.0.x branch (#3135)

* Changelog for 3.0.9

* Backport PR #3149: Add GroupNotFound error to API docs (#3179)

Co-authored-by: David Stansby <dstansby@gmail.com>

* Backport PR #3140: Suppress FileNotFoundError when deleting keys in the obstore adapter (#3180)

Co-authored-by: Lukas Bindreiter <lukas.bindreiter@tilebox.com>

* Backport PR #3138: Add with_read_only() convenience method to store (#3181)

Co-authored-by: Max Jones <14077947+maxrjones@users.noreply.github.com>

* Create read only copy if needed when opening a store path (#3156)

* Create read only copy if needed when opening a store path

* Add ValueError to Raises section

* Update expected warning

* Update src/zarr/storage/_common.py

Co-authored-by: Davis Bennett <davis.v.bennett@gmail.com>

* Use ANY_ACCESS_MODE

* Update src/zarr/storage/_common.py

Co-authored-by: David Stansby <dstansby@gmail.com>

* Update src/zarr/storage/_common.py

Co-authored-by: David Stansby <dstansby@gmail.com>

* Update changes

* Try using get_args on definition

* Revert "Try using get_args on definition"

This reverts commit 7ad760f.

* Add test

* Remove warning

* Apply suggestion for try; except shortening

Co-authored-by: Tom Nicholas <tom@earthmover.io>

* Improve code coverage

---------

Co-authored-by: Davis Bennett <davis.v.bennett@gmail.com>
Co-authored-by: David Stansby <dstansby@gmail.com>
Co-authored-by: Tom Nicholas <tom@earthmover.io>
(cherry picked from commit 5731c6c)

* Create read only copy if needed when opening a store path (#3156) (#3182)

* Create read only copy if needed when opening a store path

* Add ValueError to Raises section

* Update expected warning

* Update src/zarr/storage/_common.py



* Use ANY_ACCESS_MODE

* Update src/zarr/storage/_common.py



* Update src/zarr/storage/_common.py



* Update changes

* Try using get_args on definition

* Revert "Try using get_args on definition"

This reverts commit 7ad760f.

* Add test

* Remove warning

* Apply suggestion for try; except shortening



* Improve code coverage

---------




(cherry picked from commit 5731c6c)

Co-authored-by: Max Jones <14077947+maxrjones@users.noreply.github.com>
Co-authored-by: David Stansby <dstansby@gmail.com>
Co-authored-by: Tom Nicholas <tom@earthmover.io>

* Remove breaking check about `auto_mkdir` for FSSpecStore (#3193)

* Remove breaking check from _make_async

* Update expected error

* Change import structure to protect against AttributeError

* changelog

* add test to ensure that we can create a read-only copy of the store with auto_mkdir=False

* only test if the async wrapper is available

---------

Co-authored-by: Davis Bennett <davis.v.bennett@gmail.com>
(cherry picked from commit 5a24487)

* Remove breaking check about `auto_mkdir` for FSSpecStore (#3193) (#3203)

* Remove breaking check from _make_async

* Update expected error

* Change import structure to protect against AttributeError

* changelog

* add test to ensure that we can create a read-only copy of the store with auto_mkdir=False

* only test if the async wrapper is available

---------


(cherry picked from commit 5a24487)

Co-authored-by: Max Jones <14077947+maxrjones@users.noreply.github.com>

* Add missing import for AsyncFileSystemWrapper for `_make_async` in `_fsspec.py` (#3195)

* Add missing import for AsyncFileSystemWrapper in `_fsspec.py`

* Add missing changelog entry for AsyncFileSystemWrapper import fix

* Move AsyncFileSystemWrapper import past the version check in `_fsspec.py`

* Add newline after AsyncFileSystemWrapper import in `_fsspec.py`

* Simplify import statement for AsyncFileSystemWrapper in `_fsspec.py`

---------

Co-authored-by: Altay Sansal <altay.sansal@tgs.com>
(cherry picked from commit 97aa42f)

* Auto backport of pr 3195 on 3.0.10 (#3204)

* Remove breaking check about `auto_mkdir` for FSSpecStore (#3193)

* Remove breaking check from _make_async

* Update expected error

* Change import structure to protect against AttributeError

* changelog

* add test to ensure that we can create a read-only copy of the store with auto_mkdir=False

* only test if the async wrapper is available

---------

Co-authored-by: Davis Bennett <davis.v.bennett@gmail.com>
(cherry picked from commit 5a24487)

* Add missing import for AsyncFileSystemWrapper for `_make_async` in `_fsspec.py` (#3195)

* Add missing import for AsyncFileSystemWrapper in `_fsspec.py`

* Add missing changelog entry for AsyncFileSystemWrapper import fix

* Move AsyncFileSystemWrapper import past the version check in `_fsspec.py`

* Add newline after AsyncFileSystemWrapper import in `_fsspec.py`

* Simplify import statement for AsyncFileSystemWrapper in `_fsspec.py`

---------

Co-authored-by: Altay Sansal <altay.sansal@tgs.com>
(cherry picked from commit 97aa42f)

---------

Co-authored-by: Max Jones <14077947+maxrjones@users.noreply.github.com>
Co-authored-by: Altay Sansal <tasansal@users.noreply.github.com>
Co-authored-by: Altay Sansal <altay.sansal@tgs.com>

* 3.0.9 release notes (#3183)

* Create read only copy if needed when opening a store path (#3156)

* Create read only copy if needed when opening a store path

* Add ValueError to Raises section

* Update expected warning

* Update src/zarr/storage/_common.py

Co-authored-by: Davis Bennett <davis.v.bennett@gmail.com>

* Use ANY_ACCESS_MODE

* Update src/zarr/storage/_common.py

Co-authored-by: David Stansby <dstansby@gmail.com>

* Update src/zarr/storage/_common.py

Co-authored-by: David Stansby <dstansby@gmail.com>

* Update changes

* Try using get_args on definition

* Revert "Try using get_args on definition"

This reverts commit 7ad760f.

* Add test

* Remove warning

* Apply suggestion for try; except shortening

Co-authored-by: Tom Nicholas <tom@earthmover.io>

* Improve code coverage

---------

Co-authored-by: Davis Bennett <davis.v.bennett@gmail.com>
Co-authored-by: David Stansby <dstansby@gmail.com>
Co-authored-by: Tom Nicholas <tom@earthmover.io>
(cherry picked from commit 5731c6c)

* release notes

---------

Co-authored-by: Max Jones <14077947+maxrjones@users.noreply.github.com>
Co-authored-by: David Stansby <dstansby@gmail.com>
Co-authored-by: Tom Nicholas <tom@earthmover.io>

* release notes

---------

Co-authored-by: Lumberbot (aka Jack) <39504233+meeseeksmachine@users.noreply.github.com>
Co-authored-by: Lukas Bindreiter <lukas.bindreiter@tilebox.com>
Co-authored-by: Max Jones <14077947+maxrjones@users.noreply.github.com>
Co-authored-by: Davis Bennett <davis.v.bennett@gmail.com>
Co-authored-by: Tom Nicholas <tom@earthmover.io>
Co-authored-by: Altay Sansal <tasansal@users.noreply.github.com>
Co-authored-by: Altay Sansal <altay.sansal@tgs.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants